Перейти к основному содержимому

cohort/upload

Администратор может загрузить несколько глобальных групп из текстового файла формата CSV (значения, разделённые запятыми) в разделе Управление > Администрирование > Пользователи > Учётные записи > Глобальные группы > Загрузить глобальные группы. Глобальные группы могут быть созданы как в контексте системы (на уровне сайта), так и в контексте категории курса.

После создания глобальной группы новых пользователей можно добавить в неё на странице Загрузить пользователей, используя файл формата .CSV соответствующей структуры.

Процесс загрузки глобальных групп​

Вот краткое описание процесса:

  1. Создайте файл для загрузки глобальных групп (текстовый файл CSV с колонкой «name» и названием каждой новой глобальной группы на новой строке).
  2. Перейдите в «Управление > Администрирование > Пользователи > Учётные записи > Глобальные группы > Загрузить глобальные группы».
  3. Добавьте файл для загрузки.
  4. Предварительный просмотр загрузки глобальных групп — проверьте настройки и наличие ошибок. Если в файле обнаружены ошибки, исправьте их по мере необходимости.
  5. Загрузите глобальные группы — нажмите «Загрузить глобальные группы».
  6. Результаты загрузки глобальных групп — показывает, сколько глобальных групп было создано.
  7. Результаты загрузки глобальных групп — нажмите «Продолжить».
  8. Вернётесь на экран «Загрузить пользователей».

Настройки​

Файл​

Текстовый файл формата CSV, содержащий данные глобальных групп для загрузки. Подробнее о формате файла для загрузки глобальных групп см. в разделе Формат файла для загрузки глобальных групп.

Разделитель CSV​

Символ, используемый в качестве разделителя между полями в файле загрузки глобальных групп. Разделитель разделяет различные поля в одной строке. По умолчанию в качестве разделителя используется запятая (','); однако доступны и другие варианты.

Кодировка​

Вы можете указать кодировку символов файла загрузки глобальных групп. По умолчанию используется кодировка UTF-8.

Контекст по умолчанию​

Вы можете указать контекст по умолчанию для использования из списка доступных контекстов. Контекст по умолчанию — это контекст системы (то есть на уровне сайта). Будет представлен список категорий курсов, и одна из этих категорий курсов может быть выбрана в качестве контекста по умолчанию, если он не указан в файле загрузки глобальных групп. Если указан contextid (или одно из доступных полей для поиска contextid), то будет использоваться это значение; однако, если для определённой глобальной группы не указан contextid, будет использоваться контекст по умолчанию.

Формат файла для загрузки глобальных групп​

В текстовом файле CSV для загрузки глобальных групп поля разделены запятой (или другим разделителем). Первая строка содержит допустимые названия полей (предпочтительно в нижнем регистре). Остальные строки (записи) содержат информацию о каждой новой глобальной группе.

:Совет: избегайте использования специальных символов в информации о полях, таких как кавычки или другие запятые. Протестируйте файл с одной записью перед массовой загрузкой. :Совет: вы можете использовать программу для работы с электронными таблицами для создания файла с требуемыми колонками и полями. Затем сохраните файл как «CSV (значения, разделённые запятыми)». Эти файлы затем можно открыть с помощью простых текстовых редакторов для проверки.

Пример допустимого файла для тестирования загрузки​

Вот пример простого допустимого файла для загрузки глобальных групп: (заголовки столбцов в первой строке файла выделены жирным только в этом примере, чтобы отличить их от остальной части данных/подробной информации о пользователе)

name,idnumber,description
Class of 2019,2019,Members of the Class of 2019
Class of 2020,2020,Members of the Class of 2020

Поля, которые можно включить​

  • Обязательные поля:

    name — название глобальной группы, которую нужно создать.

  • Дополнительные поля: чтобы указать значения, отличные от значений по умолчанию, включите одно или несколько из следующих дополнительных полей:

    contextid — используется для указания идентификатора контекста глобальных групп, которые вы загружаете. Например, идентификатор контекста определённой категории курса.

    idnumber — используется для указания идентификатора глобальных групп, которые вы загружаете.

    description — используется для указания описания глобальных групп, которые вы загружаете.

    descriptionformat — используется для указания текстового формата описания. По умолчанию формат описания установлен на рекомендованное значение 1 (FORMAT_HTML); однако также доступны значения 0 (FORMAT_MOODLE) и 2 (FORMAT_PLAIN). Эти значения формата определены в lib/weblib.php.

    visible — используется для указания того, должны ли загружаемые вами глобальные группы быть видимыми (1) или нет (0).

  • Дополнительные поля: при необходимости есть несколько дополнительных полей, которые обычно не используются, но могут быть применены. Дополнительные поля обычно требуют поиска информации в других таблицах (например, в таблицах категорий курсов или контекстов). Дополнительные поля предоставляют альтернативный способ поиска идентификатора контекста категории курса. Рекомендуется проявлять некоторую осторожность при использовании этих дополнительных полей. Список дополнительных полей включает:

    context — используется для указания названия контекста для каждой из загружаемых вами глобальных групп.

    category — используется для указания названия категории для каждой из загружаемых вами глобальных групп. Например, название категории определённого курса.

    category_id — используется для указания идентификатора категории курса (не idnumber) для каждой из загружаемых вами глобальных групп. Например, идентификатор категории курса определённого курса.

    category_idnumber — используется для указания идентификатора категории курса (не id) для каждой из загружаемых вами глобальных групп. Например, идентификатор категории курса определённого курса.

    category_path — используется для указания пути к категории курса для каждой из загружаемых вами глобальных групп. Например, путь к категории курса определённого курса.

См. также​